home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio / Ham Radio CD-ROM (Emerald Software) (1995).ISO / tech / sim68102 / sim68.doc next >
Text File  |  1990-03-09  |  8KB  |  397 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                                        SIM68
  9.  
  10.                                     Version 1.02
  11.  
  12.  
  13.  
  14.  
  15.  
  16.             Welcome  to  the  latest  release  of  SIM68,  the  Motorola
  17.             MC68HC11 simulator  designed to  allow the  product engineer
  18.             and programmer to run and debug 68HC11 .S19 object code on a
  19.             IBM, or equivalent PC.
  20.  
  21.             SIM68 allows you to load and watch your object code run in a
  22.             manner similar to the format presented by Motorola's BUFFALO
  23.             monitor, but with a full screen display on an IBM compatible
  24.             PC, and just a few more features...
  25.  
  26.             Below is a list of some of the SIM68 programming features:
  27.  
  28.                  Set and alter program breakpoints
  29.  
  30.                  Enable a  full time  display  of  a  memory  location's
  31.                  contents during  program  execution,  this  feature  is
  32.                  known as the watchpoint function
  33.  
  34.                  Enable the display of 32 bytes of contiguous memory, ie
  35.                  useful for examining buffers and caches
  36.  
  37.                  A CPU  cycle stop  watch which  allows you  to  perform
  38.                  actual  CPU cycle timing of program loops
  39.  
  40.                  A memory mapping feature displaying the actual physical
  41.                  block of memory that code has been loaded into, this is
  42.                  useful for  designing, and  revising the  memory map of
  43.                  your processor
  44.  
  45.                  A feature  that allows the modification of register and
  46.                  memory location contents during program execution
  47.  
  48.                  Full support  of all  68HC11 Op  Codes, for  a non-test
  49.                  mode system
  50.  
  51.                  The ability  to run a user defined assembler and editor
  52.                  from within the SIM68 debugging environment
  53.  
  54.                  The ability  to simulate all of the MC68HC11 interrupts
  55.                  at any point during program's execution
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.                  SIM68 displays source code or disassembled object  code
  75.                  during simulation.  The display of source code is based
  76.                  on the  presence  of  an  AS11    (Motorola's  freeware
  77.                  Assembler) list file ending in .lst i.e.,
  78.  
  79.                       AS11 test.asm -l > test.lst
  80.  
  81.                  The ability  to  display  and  modify  memory  contents
  82.                  including  program   instructions  dynamically   during
  83.                  program execution
  84.  
  85.                  Improved run  time simulation  speed, ie  faster screen
  86.                  updates and code interpretation
  87.  
  88.                  Logging of simulator session to disk and/or printer
  89.  
  90.                  The  ability   to  save   and  restore  previous  SIM68
  91.                  sessions, including  all watchpoints,  breakpoints, and
  92.                  any other  system parameters  used in  your last  SIM68
  93.                  session
  94.  
  95.                  And much more...
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.             Disclaimer
  141.  
  142.             I have  spent a  great deal  of time ensuring that the SIM68
  143.             68HC11 simulator  provides an accurate representation of the
  144.             manner in  which the actual Motorola 68HC11 Micro-controller
  145.             executes instructions.  However...
  146.  
  147.             No warranties of any kind are expressed or implied by myself
  148.             or this product.  I assume no responsibility for any damages
  149.             caused as  a result  of using  this package. I hereby commit
  150.             SIM68 version  1.02 into  the  public  domain,  for  use  in
  151.             private and commercial engineering environments.
  152.  
  153.  
  154.  
  155.             The Future
  156.  
  157.             The SIM68  simulator  package  will  continue  to  grow  and
  158.             evolve, gaining  the ability  to emulate  more of  the  true
  159.             internal functions of the Motorola 68HC11 mirco-controller.
  160.  
  161.             The SIM68  package is  written in the C programming language
  162.             (using  Borland's   Turbo-C  compiler   version   2.0)   and
  163.             assembler.  The source code is available for sale.
  164.  
  165.             If you  have any  problems or suggestions please write to me
  166.             at the following address:
  167.  
  168.                            Perry J. Fisch
  169.                            464 Green Spring Circle
  170.                            Winter Springs, FL 32708
  171.  
  172.  
  173.  
  174.  
  175.             The Catch...
  176.  
  177.             I shall  always try to post the latest changes made to SIM68
  178.             in a  timely manner.   I would like to propose the following
  179.             options to the serious SIM68 user:
  180.  
  181.  
  182.  
  183.             Fee schedule:
  184.  
  185.             Full SIM68 documentation, and user registration,     $25.00
  186.             this provides the user with notification of SIM68
  187.             updates and optional mailing of new releases.
  188.  
  189.             Full SIM68 source code and documentation            $200.00
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.             All fees  should be  made via   check  made payable to Perry
  207.             Fisch and mailed to the above address.
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.             System Requirements
  273.  
  274.             The current  SIM68 package (Version 1.02) requires a minimum
  275.             of 384Kb  or memory,  monochrome or  color monitor,  and  an
  276.             optional printer.
  277.  
  278.             As stated  above the 384 Kb of memory is what SIM68 needs to
  279.             load and  operate, any  additional memory  will be  used  to
  280.             support the  external  editor  and  assembler,  and  program
  281.             virtual memory.
  282.  
  283.  
  284.  
  285.             Installation of SIM68
  286.  
  287.             Simply copy  the SIM68.EXE file to a working directory.  You
  288.             will notice  that SIM68 creates a SIM68.CFG file after SIM68
  289.             has  been   configured.    This  file  contains  your  color
  290.             preferences as  well as  the choice of editor, assembler and
  291.             working directory name.
  292.  
  293.             To start SIM68 just type:
  294.  
  295.                       SIM68 <cr>,  where <cr>  is the carriage return or
  296.                       enter key
  297.  
  298.             SIM68 will  realize that  this is the first time the package
  299.             has been  run and  automatically route  you to  the  install
  300.             SIM68 menu.   Simply  answer the questions as presented, and
  301.             save your choices.
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.             Running SIM68
  339.  
  340.             After typing  SIM68 at  the DOS prompt you will be presented
  341.             with a menu of six choices:
  342.  
  343.                       1) Run SIM68
  344.  
  345.                       2) Change Working Directory
  346.  
  347.                       3) Run User Defined Editor
  348.  
  349.                       4) Run User Defined Assembler
  350.  
  351.                       5) Configure SIM68
  352.  
  353.                       6) Exit to DOS
  354.  
  355.             Note this  is not  a literal  list of options, but I hope it
  356.             helps convey the meaning of the options.
  357.  
  358.             Option 1  is obviously the work horse of the system, this is
  359.             where the  user  S19  code  is  actually  run.    After  the
  360.             simulator loads  your S19  file and program list file (.LST,
  361.             if present)  into it's memory you will see the SIM68 working
  362.             screen with  a display  of register  contents and  a comment
  363.             window. At  this point  hit the  F1 key and the package will
  364.             give a good description of all of it's abilities.
  365.  
  366.             From this  point forward  you are  on your  own. I'm  in the
  367.             middle of  version 2.0 and I've got a lot of work to do, not
  368.             to mention  the fact  that I  wrote SIM68 to be a tool not a
  369.             product, and  I've got  a lot  of work  to do  on my  68HC11
  370.             system.
  371.  
  372.             Good luck, and I hope this proves useful you all. Please let
  373.             me know  if you have any problems with the package, I really
  374.             do want to make this a useful product.
  375.  
  376.             Perry Fisch
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.